home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-02 / pas_all.zip / TI1262.ASC < prev    next >
Text File  |  1993-02-10  |  28KB  |  925 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.   PRODUCT  :  Borland/Turbo Pascal                  NUMBER  :  1262
  9.   VERSION  :  7.0 & 1.5
  10.        OS  :  WIN
  11.      DATE  :  February 10, 1993                       PAGE  :  1/14
  12.  
  13.     TITLE  :  Turbo Debugger for Windows Installation
  14.  
  15.  
  16.  
  17.  
  18.   The Turbo Debugger for Windows (TDW) handles most 2-, 4-, 16- and
  19.   256-color high-resolution Super VGA modes, but if your card or
  20.   mode isn't supported you need to use a special Super VGA DLL.
  21.  
  22.   This document is designed to give you the information needed to
  23.   use the Super VGA DLLs available from Borland for the Turbo
  24.   Debugger for Windows. This document assumes that you are using
  25.   Windows 3.1. If you are using Windows 3.0 read the section
  26.   "Question & Answer" for information on how to run TDW under that
  27.   version of Windows.
  28.  
  29.   Quick Start:   The instructions given here are step-by-step
  30.   instructions on how to configure TDW to use the Super VGA DLLs
  31.   available from Borland.
  32.  
  33.   Before beginning, you should read the section "Two General Tips."
  34.   Also, you should know which DLL you need and make sure that it is
  35.   in the same directory as your TDW.EXE (usually the BIN
  36.   directory).  If you don't know which DLL you need, you can find
  37.   the DLL that matches your video card in the "CARD-DLL Table" (if
  38.   your video card is not listed use SVGA.DLL).  If you do not have
  39.   the DLL you need, see "Where to Find DLLs" for the online sources
  40.   for the DLLs.  Once you have your DLL, read the section in "DLL
  41.   Descriptions" that relates to your DLL.
  42.  
  43.   When you have the DLL you need and know what options are
  44.   required, you are ready to begin.
  45.  
  46.          1) Confirm that there is a copy of TDW.INI in your Windows
  47.   directory. If it is not there, move the copy from the BIN
  48.   directory to the Windows directory.  Once you have a copy in the
  49.   Windows directory, delete the copy of TDW.INI in the BIN
  50.   directory.  You should only have one copy of TDW.INI.
  51.  
  52.          2) Load TDW.INI in an editor that reads and writes ASCII
  53.   files (such as Windows Notepad). Set the VideoDLL to point
  54.   to the DLL you are using.
  55.  
  56.          Example: VideoDLL=C:\BP\BIN\SVGA.DLL
  57.  
  58.          3) Set any options needed for your card as noted in the
  59.   "DLL Descriptions" section. The options are explained in the
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.   PRODUCT  :  Borland/Turbo Pascal                  NUMBER  :  1262
  75.   VERSION  :  7.0 & 1.5
  76.        OS  :  WIN
  77.      DATE  :  February 10, 1993                       PAGE  :  2/14
  78.  
  79.     TITLE  :  Turbo Debugger for Windows Installation
  80.  
  81.  
  82.  
  83.  
  84.   section "TDW.INI Options".  When you are finished, save TDW.INI
  85.   and exit the editor.
  86.  
  87.          4) Try using TDW. If it works fine, you're done. If it is
  88.   not working properly, read the sections "TDW.INI Options" and
  89.   "Question & Answer" for additional information. There may be
  90.   options that are not normally required for your DLL that will fix
  91.   the problem you are having.  Try specifying a debug file to get
  92.   more information on what is happening.
  93.  
  94.          5) If you still cannot get TDW to work and you are using a
  95.   card-specific DLL, return to step 1 and try SVGA.DLL. If SVGA.DLL
  96.   does not work, call Borland Technical Support. The number for
  97.   Pascal Support is 408-461-9177.  Choose the Installation and
  98.   Configuration group from the option menu.
  99.  
  100.   Two General Tips
  101.  
  102.   All TDW DLLs can use the dEBUGfILE option in the TDW.INI file. If
  103.   you are having problems and you cannot resolve it with the
  104.   information given here, you should generate a log file before
  105.   calling Borland Technical Support.  The section "TDW.INI Options"
  106.   contains more information on using this option.
  107.  
  108.   If you follow all the instructions but are having no luck,  try
  109.   booting clean. This means REMing out any unneeded lines in
  110.   AUTOEXEC.BAT and CONFIG.SYS. Also, make sure that you are not
  111.   running any programs when starting Windows (including programs
  112.   like Norton Desktop). This means you must use the program
  113.   manager, have nothing on the Load and Run lines in the WIN.INI
  114.   file, and nothing in your Startup folder. Booting clean can help
  115.   identify possible cases of software/hardware conflicts.
  116.  
  117.  
  118.     CARD and DLL TABLE
  119.     NOTE: ANY card can use SVGA.DLL (except TIGA)
  120.  
  121.     8514/A (single-screen) ... ULTRA.DLL
  122.     8514/A (dual-screen) ..... DUAL8514.DLL
  123.     Acer VGA ................. SVGA.DLL
  124.     ATI 8514 ................. ULTRA.DLL
  125.     ATI Ultra ................ ULTRA.DLL
  126.     ATI Ultra Pro ............ SVGA.DLL
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.   PRODUCT  :  Borland/Turbo Pascal                  NUMBER  :  1262
  141.   VERSION  :  7.0 & 1.5
  142.        OS  :  WIN
  143.      DATE  :  February 10, 1993                       PAGE  :  3/14
  144.  
  145.     TITLE  :  Turbo Debugger for Windows Installation
  146.  
  147.  
  148.  
  149.  
  150.     ATI Vantage .............. ULTRA.DLL
  151.     ATI Wonder+ .............. ATI.DLL
  152.     ATI XL ................... ATI.DLL
  153.     Diamond Speedstar ........ TSENG.DLL
  154.     Diamond Stealth .......... SVGA.DLL
  155.     EGA ...................... SVGA.DLL
  156.     Genoa .................... SVGA.DLL, TDVESA.DLL
  157.     Graphics Ultra ........... ULTRA.DLL
  158.     Oak Tech. ................ SVGA.DLL
  159.     Orchid Prodesigner II .... TSENG.DLL
  160.     Orchid Fahrenheit 1280 ... SVGA.DLL
  161.     Paradise ................. SVGA.DLL, TDVESA.DLL
  162.     S3 Chipset cards ......... SVGA.DLL
  163.     STB MVP-2 ................ STB.DLL
  164.     TIGA ..................... support is pending
  165.     Trident .................. SVGA.DLL
  166.     Tseng ET-3000/ET-4000 .... TSENG.DLL
  167.     VESA-compatible .......... TDVESA.DLL
  168.     Video-7 .................. SVGA.DLL
  169.     VRAM ..................... SVGA.DLL
  170.     XGA ...................... SVGA.DLL
  171.     Any Other cards .......... SVGA.DLL
  172.     Where to find DLLs
  173.  
  174.   If you need a DLL that was not included with your compiler,  you
  175.   should download the file TDSVGA.ZIP.  TDSVGA.ZIP contains all
  176.   available DLLs and is available on CompuServe in BPASCAL LIB 3,
  177.   and on Borland's DLBBS (408-439-9096, 8N1-1200,2400 or 9600) in
  178.   the Assembler/Debugger/Profiler Miscellaneous section.  We are
  179.   constantly creating DLLs for new video cards and modes that
  180.   appear on the market.  If the card you use isn't supported by one
  181.   of our DLLs, please contact Tech Support for the latest video DLL
  182.   information.  The Pascal Support phone number is 408-461-9177.
  183.  
  184.  
  185.   DLL Descriptions
  186.  
  187.   TDW makes calls to the DLL to handle the entire video screen-
  188.   switching context.  The DLL allocates a buffer as it gets loaded
  189.   and graphic screen contents are saved to this buffer when TDW
  190.   enters text mode.  The DLL restores the graphics screen from this
  191.   buffer when TDW exits text mode.  Memory allocated for the buffer
  192.   is freed when the DLL is unloaded.
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.   PRODUCT  :  Borland/Turbo Pascal                  NUMBER  :  1262
  207.   VERSION  :  7.0 & 1.5
  208.        OS  :  WIN
  209.      DATE  :  February 10, 1993                       PAGE  :  4/14
  210.  
  211.     TITLE  :  Turbo Debugger for Windows Installation
  212.  
  213.  
  214.  
  215.  
  216.   If there is an error loading the DLL, or if the DLL doesn't
  217.   support the selected card or mode, TDW reports the error in a
  218.   Windows dialog box.  When this happens, TDW unloads the DLL and
  219.   exits.  If this situation occurs, remove the DLL's name from the
  220.   VideoDLL line in the TDW.INI file or select a video mode that is
  221.   supported by that DLL.
  222.  
  223.   All of these video DLLs assume you are using the most current
  224.   Windows screen drivers for your video card.  If you are not sure
  225.   if you are using the latest drivers, contact your video card
  226.   manufacturer for more information.
  227.  
  228.  
  229.   ATI.DLL  (Shipped with TDW 3.1 and later)
  230.  
  231.   Supports ATI VGA Wonder+ and XL cards in certain video modes.
  232.  
  233.   You must use the latest (4.22.92 or later) Windows screen drivers
  234.   for this DLL.  ATI.DLL is required in all video modes except for
  235.   1024*768 modes.  When this DLL is used the Int2FAssist should be
  236.   set to YES.
  237.  
  238.          Resolution   ATI.DLL Int2FAssist
  239.        ----------------------------------
  240.        | 640*480    | Yes    |   Yes    |
  241.        ----------------------------------
  242.        | 800*600    | Yes    |   Yes    |
  243.        ----------------------------------
  244.        | 1024*768   | No     |    No    |
  245.        ----------------------------------
  246.  
  247.  
  248.   DUAL8514.DLL  (Shipped with TDW 3.1)
  249.  
  250.   Supports any dual-screen 8514 cards.
  251.  
  252.   This DLL is only for systems that have two color monitors: one
  253.   attached to the VGA card and one attached to the 8415/A card.
  254.   This DLL speeds up performance by preventing TDW from doing
  255.   things that aren't required in dual monitor mode.
  256.  
  257.   NOTE: Using this DLL is not the same as invoking TDW with the -do
  258.   parameter, which specifies a monochrome debug screen.
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.   PRODUCT  :  Borland/Turbo Pascal                  NUMBER  :  1262
  273.   VERSION  :  7.0 & 1.5
  274.        OS  :  WIN
  275.      DATE  :  February 10, 1993                       PAGE  :  5/14
  276.  
  277.     TITLE  :  Turbo Debugger for Windows Installation
  278.  
  279.  
  280.  
  281.  
  282.   STB.DLL  (Shipped with TDW 3.1)
  283.  
  284.   Supports multi-screen video cards.
  285.  
  286.   The STB DLL has been developed for use with the MVP2 and MVP4
  287.   series of video cards.
  288.  
  289.   NOTE: The MVP-2 card has two ET-4000 ports on it; the DLL puts
  290.   TDW on one and Windows on the other.
  291.  
  292.  
  293.   SVGA.DLL  (See "Where to Find DLLs")
  294.  
  295.   Supports all video cards and modes (except TIGA).
  296.  
  297.   Suggested for: EGA, Trident, Video-7, Oak Tech., Paradise, XGA,
  298.   or any card not supported by another DLL.
  299.  
  300.   This DLL is designed to support ALL video cards. SVGA is
  301.   slightly  slower than the card-specific DLLs, but it has a
  302.   broader range. If there is a specific DLL that supports your
  303.   card, you should use that one, if possible.
  304.  
  305.   This DLL will support any video card/mode using undocumented
  306.   Windows functions that force the Windows display driver to do the
  307.   mode switching. (The TIGA card is not supported by this DLL
  308.   because it does not support the undocumented Windows functions
  309.   used by this DLL.) The Windows screen is saved into a full screen
  310.   sized bitmap using the BitBlt API call.  It also uses two Device
  311.   Contexts (DCs) throughout the life of the debugger, so if you use
  312.   various other Windows resources in your program and you notice
  313.   unusual behaviors, you may want to disable the BitBlt option.
  314.   On coprocessor cards ( or those that are referred to as "Windows
  315.   Accelerators" ) the response time is fairly good even in 1024x768
  316.   modes.  On non-coprocessor cards, the higher the resolution, the
  317.   longer it will take for the screen switch to occur.  (The "screen
  318.   switch" is the transition from the Windows screen to the debugger
  319.   screen or vice versa.)  There are some options that can be
  320.   specified in the TDW.INI file, under the [VideoOptions] section,
  321.   that may improve performance:
  322.  
  323.  
  324.          BitBlt=YES|NO
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.   PRODUCT  :  Borland/Turbo Pascal                  NUMBER  :  1262
  339.   VERSION  :  7.0 & 1.5
  340.        OS  :  WIN
  341.      DATE  :  February 10, 1993                       PAGE  :  6/14
  342.  
  343.     TITLE  :  Turbo Debugger for Windows Installation
  344.  
  345.  
  346.  
  347.  
  348.          YES saves the bitmap of the screen
  349.  
  350.   This is on by default and only needs to be specified in order to
  351.   disable it.  If disabled, the DLL does not allocate the bitmap,
  352.   the DCs or saves the entire screen each screen swap. If you
  353.   disable BitBlt, you will not see anything on the user screen
  354.   <Alt-F5> until you run the program and control goes back to
  355.   Windows.
  356.  
  357.          ForceRepaint=YES|NO
  358.          YES has Windows repaint the screen
  359.  
  360.   This option is on by default but only takes effect if BitBlt is
  361.   disabled.  This forces Windows to repaint the whole screen when
  362.   your program is run and you are not saving the whole screen in
  363.   the bitmap.  If you disable this option, you won't see anything
  364.   on the Windows screen until your program invalidates something
  365.   and repaints it.
  366.  
  367.   On XGA and other high-powered coprocessor cards, the BitBlt
  368.   option should be fast enough to use pleasantly (set BitBlt=YES).
  369.  
  370.  
  371.   TDVESA.DLL  (Shipped with TDW 3.1)
  372.  
  373.   Supports any VESA-compliant video card -- the VESA emulation is
  374.   usually available through a TSR or is implemented on board the
  375.   video card.
  376.  
  377.   NOTE: You can use the VESATEST.EXE program to see if your system
  378.   provides the proper VESA functions.  VESATEST.EXE can be run from
  379.   either DOS or Windows.
  380.  
  381.   TDVESA.DLL is required for VESA-compliant video cards. These
  382.   include the Video-7 VRAM II and the Weitek Power Windows range of
  383.   video cards. Make sure that you load the VESA emulation before
  384.   launching Windows. If the emulation is not loaded, TDW will
  385.   display an error message indicating that the video DLL is not
  386.   supported by the current configuration. You can use the
  387.   VESATEST.EXE program under Windows or DOS to determine if your
  388.   card supports the proper VESA functions.
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.   PRODUCT  :  Borland/Turbo Pascal                  NUMBER  :  1262
  405.   VERSION  :  7.0 & 1.5
  406.        OS  :  WIN
  407.      DATE  :  February 10, 1993                       PAGE  :  7/14
  408.  
  409.     TITLE  :  Turbo Debugger for Windows Installation
  410.  
  411.  
  412.  
  413.  
  414.   This DLL should provide compatibility with Video-7, Paradise,
  415.   Trident, Genoa and others if you also get the VESA TSR from the
  416.   card companies.
  417.  
  418.   The TDVESA.DLL has been tested with the following configurations:
  419.  
  420.            Video Card         VESA TSR Required  TDVESA.DLL
  421.       --------------------------------------------------------
  422.       |Video-7 VRAM II      |  Yes - V7VESA*    |    Yes     |
  423.       --------------------------------------------------------
  424.       |Weitek Power Windows |  No               |    Yes     |
  425.       --------------------------------------------------------
  426.  
  427.     * This TSR is supplied with the Video-7 VRAM II card
  428.  
  429.  
  430.   TSENG.DLL  (Shipped with TDW 3.1)
  431.  
  432.   Supports TSENG ET-3000/ET-4000 cards in certain video modes. You
  433.   must use the latest (3.01.92 or later) Windows screen drivers for
  434.   this DLL.
  435.  
  436.   TSENG.DLL only needs to be used in the 640*480*25 resolution; in
  437.   all other cases TSENG.DLL is not required.  This DLL supports 16
  438.   and 256 colors only. The Int2FAssist should be set to YES when
  439.   this video DLL is used.
  440.  
  441.          Resolution   TSENG.DLL  Int2FAssist
  442.        -------------------------------------
  443.        | 640*480    | Yes       |   Yes    |
  444.        -------------------------------------
  445.        | 800*600    | No        |    No    |
  446.        -------------------------------------
  447.        | 1024*768   | No        |    No    |
  448.        -------------------------------------
  449.  
  450.  
  451.   ULTRA.DLL  (Shipped with TDW 3.1)
  452.  
  453.   Supports 8514 cards with single-monitor configuration.
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.   PRODUCT  :  Borland/Turbo Pascal                  NUMBER  :  1262
  471.   VERSION  :  7.0 & 1.5
  472.        OS  :  WIN
  473.      DATE  :  February 10, 1993                       PAGE  :  8/14
  474.  
  475.     TITLE  :  Turbo Debugger for Windows Installation
  476.  
  477.  
  478.  
  479.  
  480.   You must use the latest (4.22.92 or later) Windows screen drivers
  481.   for this DLL. The Ultra card must also have a ROM version of 1.3
  482.   or later.
  483.  
  484.   This DLL will work with the 8514/Ultra, 8514/Vantage,
  485.   Graphics/Ultra and Graphics/Vantage cards. It will also work on
  486.   most IBM 8514/A cards with single monitors.
  487.  
  488.   NOTE: The version of the DLL shipped with TDW 3.1 requires that a
  489.   Debugfile be specified. We recommend naming the debug file
  490.   TDW.LOG and placing it in the BIN directory.
  491.  
  492.   TDW.INI Options
  493.  
  494.   To use a SuperVGA DLL, simply edit the TDW.INI file that the
  495.   installation program puts in your main Windows directory.
  496.  
  497.   ** You must have only one copy of TDW.INI.  If there is a copy in
  498.   the Windows directory and a copy in the BP\BIN or TPW directory,
  499.   delete the copy in the BIN directory. If there is a copy in the
  500.   BIN directory but not in the Windows directory, move (don't copy)
  501.   TDW.INI to the Windows directory.
  502.  
  503.   You can modify TDW.INI with any ASCII text editor.  Under the
  504.   section heading [TurboDebugger] there is an option called
  505.   "VideoDLL".  This entry should have both the path and filename of
  506.   the DLL you want to use.
  507.  
  508.          Example: VideoDLL=C:\BP\BIN\SVGA.DLL
  509.  
  510.   There are also options you can set for the current video DLL.
  511.   These options must be under the [VideoOptions] heading, but in
  512.   any order you like.
  513.  
  514.   The following list shows all the video options and the default
  515.   values:
  516.  
  517.     SaveWholeScreen        default = NO
  518.     Int2FAssist            default = NO
  519.     dEBUGfILE              default =
  520.     IgnoreMode             default = NO
  521.     ATI                    default = YES
  522.     Rows                   default = 25
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.   PRODUCT  :  Borland/Turbo Pascal                  NUMBER  :  1262
  537.   VERSION  :  7.0 & 1.5
  538.        OS  :  WIN
  539.      DATE  :  February 10, 1993                       PAGE  :  9/14
  540.  
  541.     TITLE  :  Turbo Debugger for Windows Installation
  542.  
  543.  
  544.  
  545.  
  546.     RestoreTextScreen      default = YES
  547.     ForceRepaint           default = NO
  548.  
  549.   Debugfile can be either blank or set to a specific filename
  550.   (except when using ULTRA.DLL).  The Rows option must be set to 25
  551.   or 50. The other settings should be either YES or NO.
  552.  
  553.  
  554.   SaveWholeScreen
  555.  
  556.   The graphics screen is cleared when switching modes.  This
  557.   option, normally set to NO, determines whether the entire screen
  558.   is saved (64k x 8 planes = 512k) or if only the first 32k of the
  559.   first four planes is saved (32k x 4 planes = 128k).
  560.  
  561.   Saving the whole screen is not usually necessary, but is provided
  562.   in case you're using a nonstandard card that requires that the
  563.   whole screen be saved.  It also provides support for <Alt-F5>
  564.   when using the Int2FAssist mode.
  565.  
  566.   Int2FAssist
  567.  
  568.   This option, normally set to NO, tells the DLL to make a special
  569.   Int 2F call before switching video modes. This call tells the
  570.   current Windows screen driver what's happening. The desired side
  571.   effect of this call is to make Windows tell all of its child
  572.   windows to repaint themselves. This option is provided mainly to
  573.   support some ATI Wonder and TSENG chipset video modes.
  574.  
  575.  
  576.   DebugFile
  577.  
  578.   The video DLL normally doesn't log any debugging information. If
  579.   you're having problems using a DLL, you can use the Debugfile
  580.   option to specify the path and filename of a log file. You will
  581.   want the information logged in this file if you contact Borland
  582.   Technical Support.
  583.  
  584.   The information that gets logged is:
  585.  
  586.          o  the date and time that you ran TDW
  587.          o  the version & location of the DLL
  588.          o  the name of the current Windows screen driver
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.   PRODUCT  :  Borland/Turbo Pascal                  NUMBER  :  1262
  603.   VERSION  :  7.0 & 1.5
  604.        OS  :  WIN
  605.      DATE  :  February 10, 1993                      PAGE  :  10/14
  606.  
  607.     TITLE  :  Turbo Debugger for Windows Installation
  608.  
  609.  
  610.  
  611.  
  612.          o  the state of all TDW.INI options
  613.          o  a listing of all calls and parameters to the DLL's
  614.             functions
  615.  
  616.   The use of the Debugfile is optional, with the exception that the
  617.   ULTRA.DLL shipped with TDW 3.1 requires that a debug file be
  618.   specified. We recommend having the debug file named TDW.LOG and
  619.   placed in the BIN directory.
  620.  
  621.               Example: dEBUGfILE=C:\BP\BIN\TDW.LOG
  622.  
  623.  
  624.   IgnoreMode
  625.  
  626.   This option only applies when the video DLL is ATI.DLL or
  627.   TSENG.DLL. It tells the DLL not to do any mode or card checking
  628.   and to force the Int2FAssist option on.  This option is useful
  629.   for cards that aren't directly supported by a card-specific DLL
  630.   yet, such as Paradise, Video-7, Trident or any other video card
  631.   without a graphics coprocessor. With this option enabled, the
  632.   functionality is identical to the temporary ALL.DLL we offered in
  633.   the past.
  634.  
  635.   Use this option when you know you are using the right Windows
  636.   drivers and the right DLL but are still getting the error message
  637.   "Mode not supported..."
  638.  
  639.  
  640.   ATI    (ULTRA)
  641.  
  642.   This option is only used by ULTRA.DLL and is on by default.  If
  643.   you disable it, you can use the ULTRA.DLL on IBM 8514/A cards.
  644.  
  645.  
  646.   ROWS
  647.  
  648.   This option is only used if you use a configuration file to set
  649.   the number of rows to 43/50 from 25. If you want to have TDW
  650.   start in 50-line mode, you must set the rows option to 50 in the
  651.   TDW.INI file.
  652.  
  653.  
  654.   RestoreTextScreen
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.   PRODUCT  :  Borland/Turbo Pascal                  NUMBER  :  1262
  669.   VERSION  :  7.0 & 1.5
  670.        OS  :  WIN
  671.      DATE  :  February 10, 1993                      PAGE  :  11/14
  672.  
  673.     TITLE  :  Turbo Debugger for Windows Installation
  674.  
  675.  
  676.  
  677.  
  678.   This option is only valid with the DUAL8514 and STB DLLs.  The
  679.   valid options are:
  680.            Yes    - restores the debugger's screen after exiting.
  681.            No     - does not touch the debugger's screen at all.
  682.            Clear  - forces the screen to clear upon exiting TDW.
  683.  
  684.  
  685.   BitBlt    (SVGA)
  686.  
  687.   This option controls whether or not the DLL saves the entire
  688.   screen with the BitBlt API call. (See the description of SVGA.DLL
  689.   above for more information.)
  690.  
  691.  
  692.   ForceRepaint    (SVGA)
  693.  
  694.   This option controls whether Windows should repaint the entire
  695.   desktop when you return to your program. (See the description of
  696.   SVGA.DLL above for more information.)
  697.  
  698.   Some video modes may require some special handling. The
  699.   Int2FAssist option allows these modes to work correctly on most
  700.   systems. The behavior is as follows: When you set
  701.   "Int2FAssist=YES", the DLL makes Windows tell all sub-windows on
  702.   the screen to repaint themselves as the user application is
  703.   running. This allows the user screen to be viewed when stepping,
  704.   tracing or running your application. It will not, however, switch
  705.   to the user screen when you press <Alt-F5> because TDW is still
  706.   in control (and TDW doesn't allow Windows to process any messages
  707.   at this point).
  708.  
  709.   If you also set "SaveWholeScreen=YES" <Alt-F5> will show the user
  710.   screen. (The DLL will now copy the screen back for you.) The
  711.   drawback to enabling SaveWholeScreen is that it will take longer
  712.   to step or trace if TDW needs to switch back to the user screen
  713.   for that particular instruction. Also, extra messages will be
  714.   passed to your application that normally would not be passed.
  715.   This may affect the debugging of certain pieces of code (like
  716.   finding a bug in an owner-draw control). In these cases, you
  717.   won't want to use this option on the current video mode.
  718.  
  719.  
  720.   Question & Answer
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.   PRODUCT  :  Borland/Turbo Pascal                  NUMBER  :  1262
  735.   VERSION  :  7.0 & 1.5
  736.        OS  :  WIN
  737.      DATE  :  February 10, 1993                      PAGE  :  12/14
  738.  
  739.     TITLE  :  Turbo Debugger for Windows Installation
  740.  
  741.  
  742.  
  743.  
  744.   QUESTION:
  745.         I have set TDW to come up in 43/50 line mode, but it stays
  746.   in  25 lines when I run it.
  747.  
  748.   ANSWER:
  749.         Put ROWS=50 in your TDW.INI file under the [VideoOptions]
  750.   section.  If you are using an EGA card, use the latest version of
  751.   SVGA.DLL (version 3.2.1 or later) and you can set ROWS=43.
  752.  
  753.  
  754.   QUESTION:
  755.         I made changes to my TDW.INI file, but they seem to have no
  756.   effect.
  757.  
  758.     ANSWER:
  759.        The installation process may incorrectly put a copy of the
  760.   TDW.INI file in both the BIN and Windows directories.  Delete the
  761.   TDW.INI in the BIN directory and use the one in the Windows
  762.   directory, instead.  This problem has been noticed with both
  763.   Borland C++ 3.1 and Turbo Pascal for Windows 1.5.
  764.  
  765.  
  766.   QUESTION:
  767.        Can I use TDW to debug mouse-related events such as mouse
  768.   cursor movement and mouse clicks?
  769.  
  770.   ANSWER:
  771.        Yes, but you need to do so with care, since the debugger
  772.   traps  the mouse messages for itself and throws away those that
  773.   don't apply.  For example, if you set a breakpoint on a
  774.   WM_LBUTTONDOWN (left mouse button pressed) for your scrollbar,
  775.   run your program, and click the mouse on the scrollbar button,
  776.   TDW hits the breakpoint and switches to its screen.  At this
  777.   point, if you release the mouse button that you were still
  778.   pressing, the WM_LBUTTONUP message goes to TDW, which isn't
  779.   expecting it, so it gets thrown away.  When you continue running
  780.   your program, it thinks that the mouse button is still being
  781.   pressed since it never received the "up" message, and the scroll
  782.   bar is continuously scrolling.  The solution is to press the
  783.   mouse  button in TDW before continuing the program (after hitting
  784.   the breakpoint) so that you release it in Windows and your scroll
  785.   bar sees the message.
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.   PRODUCT  :  Borland/Turbo Pascal                  NUMBER  :  1262
  801.   VERSION  :  7.0 & 1.5
  802.        OS  :  WIN
  803.      DATE  :  February 10, 1993                      PAGE  :  13/14
  804.  
  805.     TITLE  :  Turbo Debugger for Windows Installation
  806.  
  807.  
  808.  
  809.  
  810.   QUESTION:
  811.        I want to use TDW with an EGA card.  Which DLL do I use?
  812.  
  813.   ANSWER: SVGA.DLL.
  814.  
  815.  
  816.   QUESTION:
  817.        How do I run TDW in an OS/2 Windows session with an 8514 or
  818.   XGA video card?
  819.  
  820.   ANSWER:
  821.         You need to use VideoDLL=(path)\SVGA.DLL in your TDW.INI.
  822.   You also need to run RC.EXE on the DLL with the -30 switch:
  823.  
  824.     RC.EXE -30 SVGA.DLL
  825.   This prevents an error message that says that there was an error
  826.   loading TDVIDEO.DLL.  The Windows resource compiler by default
  827.   marks an EXE or DLL as being Windows 3.1 compatible ONLY.  WinOS2
  828.   uses a copy of Windows 3.0 (not 3.1), so when TDW tries to load
  829.   the DLL, WinOS2 won't let it.  This will work for any of the TDW
  830.   DLLs, and it will also work for people using Windows 3.0 and not
  831.   Windows 3.1.
  832.  
  833.  
  834.   QUESTION:
  835.        When I invoke TDW, my machine just hangs.  I'm using
  836.   ULTRA.DLL.
  837.  
  838.   ANSWER:
  839.        Make sure that you are specifying a Debugfile in TDW.INI.
  840.   The ULTRA.DLL that shipped with Turbo Pascal 1.5 may cause TDW to
  841.   hang upon  execution unless you specify a Debugfile in TDW.INI.
  842.   Also, make  sure that a TDW.INI file does NOT exist in the BIN
  843.   directory.  If  so, delete it and use the TDW.INI in the Windows
  844.   directory  instead.
  845.  
  846.  
  847.   QUESTION:
  848.         How do I run TDW 3.1 under Windows 3.0? Why am I getting an
  849.   error message ERROR LOADING TDVIDEO.DLL?
  850.  
  851.   ANSWER:
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.   PRODUCT  :  Borland/Turbo Pascal                  NUMBER  :  1262
  867.   VERSION  :  7.0 & 1.5
  868.        OS  :  WIN
  869.      DATE  :  February 10, 1993                      PAGE  :  14/14
  870.  
  871.     TITLE  :  Turbo Debugger for Windows Installation
  872.  
  873.  
  874.  
  875.  
  876.         TDW will run fine.  If you need to use a video DLL, then
  877.   you  will need to run RC.EXE with the -30 switch on that video
  878.   DLL. If you don't do this, TDW will reply with:  ERROR LOADING
  879.   TDVIDEO.DLL.
  880.  
  881.  
  882.   QUESTION:
  883.         When I run TDW, I get an error message:  CANNOT FIND
  884.   WINDEBUG.DLL. What's wrong?
  885.  
  886.   ANSWER:
  887.        You will get this error if you are using TDW 3.0 with
  888.   Windows  3.1.  TDW 3.0 claims compatibility with Windows 3.0, and
  889.   not with Windows 3.1.  You have three options:
  890.  
  891.     1) Upgrade to TPW 1.5.  This will provide a much more stable
  892.   debugging environment with TDW and give you syntax color
  893.   highlighting, integrated resource compilation, as well as support
  894.   for multimedia, drag & drop, OLE, and pen windows.
  895.  
  896.     2) Download TPWN31.ZIP from Borland's DLBBS, CompuServe, BIX,
  897.   or GEnie.  (See the section "Where to find DLLs" earlier in this
  898.   document.)  This file contains TDWIN.DLL, which can be renamed to
  899.   WINDEBUG.DLL.  This is intended to provide only a temporary
  900.   solution.  Option #1 above is highly recommended.
  901.  
  902.     3) Use Windows 3.0 instead of Windows 3.1.
  903.  
  904.     (This particular problem is not an SVGA issue.)
  905.  
  906.   DISCLAIMER: You have the right to use this technical information
  907.   subject to the terms of the No-Nonsense License Statement that
  908.   you received with the Borland product to which this information
  909.   pertains.
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.